home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 3 / QRZ Ham Radio Callsign Database - Volume 3.iso / world / mac / digital / sftksrcs.hqx / SoftKiss.src.1.8 / docs / SoftKiss.UserManual.text < prev    next >
Text File  |  1993-07-09  |  18KB  |  413 lines
  1. **** DRAFT DRAFT *** please send corrections
  2.  
  3. Version 1.8 July 9 1993 update since 1.6
  4. KD6PAG found a bug in quoting recieved escape and end characters 
  5. is
  6. sofktiss 1.6.  The bug and the fix and patch are all correct, thanks for
  7. some great detective work.
  8.  
  9. Update phone number
  10. Overview
  11. This document tells you how to get your Mac on packet radio for less 
  12. than $50.  Some friends are working on a modem for less than $30.
  13. Written by Aaron Wohl
  14. 6393 Penn Ave #303
  15. Pittsburgh PA, 15206
  16. Phone 412-731-3691 (note: new phone)
  17. AppleLink: A0361 (seldom checked)
  18. Internet: n3liw+@cmu.edu
  19. Compuserv:  76516,2677 (note: new address)
  20. Packet: n3liw@w2xo.wpa.usa.na
  21.  
  22.                                                          
  23. Things you need to get started
  24. IP ADDRESS
  25. You need an "IP" address.  This is a 32 bit number issued by your 
  26. local ip coordinator.  It is expressed as 4 numbers separated by 
  27. periods.  It should look like 44.112.0.200.
  28. My call sign is N3LIW so I sent a request to my coordinator: "My host 
  29. is called n3liw I need one IP address.  It is located in Pittsburgh PA".
  30. I asked around to find the coordinator in my area.  I have attached 
  31. the current list of IP coordinators as Appendix 1.
  32. HOST TABLE
  33. There is a file that lists all the folks around you that also have ip 
  34. addresses.  It must have your ip address and hostname (call sign) at 
  35. least.  You can get this from your coordinator.  It looks like this:
  36. 44.112.0.1    unix.n3cvl
  37. 44.112.0.2    w3vc
  38. 44.112.0.3    darth.wa3yoa
  39. 44.112.0.4    unix.w2xo
  40. 44.112.0.5    n3igw
  41. 44.112.0.6    wa3hgw
  42. NET
  43. This is the software than emulates a "normal" TNC.  It is available 
  44. from the internet on host akutaktak.andrew.cmu.edu via anonymous 
  45. ftp in the /aw0g directory. On compuserve in the hamnet forum 
  46. library 9.  MAC/Net expects a TNC in kiss mode, which is what 
  47. Softkiss emulates.
  48. Softkiss
  49. This software emulates a really dumb TNC in kiss mode.  It is 
  50. available on the internet from host akutaktak.andrew.cmu.edu 
  51. [128.2.35.1] in the /aw0g directory.  It is also available on 
  52. compuserv hamnet forum in library 9.
  53. Software Compatibility Switch
  54. If you are using a Mac fx or quadra (or newer har har) get the 
  55. "software compatibility switch" control panel from compuserv 
  56. Macintosh Developers sig library 8 (Apple System Tools) and is called 
  57. FXSRSW.SIT.
  58. MODEM
  59. All of the above stuff is free.  The modem you have build or buy.  
  60. Stas at A&A engineering sells BayCom kits based on the 7910 modem 
  61. chip, the phone is 714 952 2114.  I have been using two of his kits in 
  62. development.  This kit supports 300 baud for HF work [untested by 
  63. n3liw].
  64. A quote from Dexter Francis: "Sigma Design Associates [Dexter Francis 
  65. KD6CNT] has a modem specifically for the macintosh that should cost 
  66. about $30.  It comes with a HyperCard stack with useful tips on 
  67. building and hooking up a modem. 408-733-8985 AppleLink: 
  68. Francis4 Compuserv: 70611,1340 XXX"
  69. I have been using a prototype of this modem.  It is line powered 
  70. which saves having an extra power cable.  Softkiss supports the line 
  71. powered option which is handy on a power book or portable.
  72. John Olson at Tigertronics sells a little line powered modem model 
  73. BayPac-2 built into a DB25 connector.  The cost is $49.  He is sent me 
  74. one to hook up and try out.  It is working well.  There is a wireing 
  75. diagram in the wireing section.  Tigertronics can be reached at 
  76. (503)474-6700.
  77. The 1992 ARLL handbook has some planes for a modem on page 29-
  78. 13 if you want to build one.
  79. 73 Magazine had an interesting article published in August 1991 
  80. 'Poor Man's Packet' by F. Kevin Feeney WB2EMS and Andy Payne.
  81. Installing The Hardware
  82. Wiring
  83. Radio
  84. Sorry no help here, the modem kit probably came with some hints?
  85. Power
  86. Unless the modem is specially designed to be low power there isn't 
  87. enough juice to steal power from the Mac.  If you have such a 
  88. modem set "line_power true" in Softkiss to leave the transmit drivers 
  89. on even in receive mode to power your modem.  Currently the 
  90. default is line_power true.  Comments? are most of you using line 
  91. powered or externaly powered modems? 
  92. Macintosh
  93. See Inside Mac Volume IV page 249.
  94. See below the pinout for the A&A Baycom modem
  95. There is no standard for Mac cable color codes, so when you get 
  96. yours working telling a friend the colors won't help
  97. The Softkiss software currently ignores the CTS (Mac pin2) signal.  
  98. If your modem supplies it you can hook it up to be ready for a future 
  99. version.  Sigma's MacPacketModem provides this signal.
  100. The Mac has two transmit data lines, ignore the TXD+(Mac pin6) 
  101. signal and use the TXD-(Mac pin3) because that is closer to being 
  102. RS232.
  103. The Mac has two receive data lines, hook the RXD+(Mac pin8) to your 
  104. circuit ground. Send data in RXD0 (Mac pin5)
  105. The DTR (Mac pin 1) signal is used to key the transmitter.  It is 
  106. active high
  107. Mac PIN 4 is ground.
  108. Don't hook anything to the GPI (Mac pin 7)
  109. Pinout for Sigma modem
  110. The Sigma modem uses a mini db-8 which is the same thing used on 
  111. a Laserwriter so you can use a standard cable.
  112. Pinout for A&A Baycom modem
  113. Mac Pinout    DB9 Pinout    Function
  114. Mini DIN8    Baycom
  115.  
  116. 1    7    DTR push to talk
  117. 2    5    MAC CTS in unused
  118. 3    4    TXD- transmit data out -
  119. 4    5    Ground
  120. 5    8    RXD-
  121. 6    NC    TXD+ transmit data out+
  122. 7    NC    Not connected
  123. 8    5    RXD+ / Ground
  124. NOTE: This is *NOT* a standard cable you can buy.  I asked A&A and 
  125. they may carry this cable made up in the future.
  126.                                                                             
  127.  
  128. Starting Softkiss
  129. Hook up the modem as described above to either Mac port but not 
  130. yet to the radio(it might key up due to the last terminal emulation 
  131. program leaving DTR on).
  132. Get whatever might be using the port on the Mac to stop using it.  If 
  133. you are connecting to the printer port be sure that AppleTalk is 
  134. turned off.  
  135. If you are using a Mac fx or quadra you need to set the serial ports 
  136. to compatibility mode.
  137. Place the SoftKiss control panel in the System Folder (system 6) or 
  138. Control panel folder (system 7) and reboot.
  139. Bring up the SoftKiss control panel and select "KISS mode TNC" for 
  140. the port you want to use for a radio.
  141. Possible Problems
  142. If the control panel says the port is busy, maybe it is (is appletalk off 
  143. if you are using port b?)
  144. If it says that there is "no scc chip" then you have an fx, quadra, or 
  145. newer and need to follow the compatibility section above.
  146. Hook up the radio, something is wrong if it keys up right now...
  147. Using Net
  148. You did get the host table and ip address talked about above in the 
  149. steal this stuff section right?
  150. Put the hosts.net file in the same directory as the NET/Mac 
  151. application. It must have at least your own ip address and hostname 
  152. (call sign) listed.  Sample minimal file:
  153. 44.112.0.200    n3xyz
  154.  
  155. Now the fun part [sic].  There is this file called "autoexec.net" you 
  156. need to put the same information in it in ten different ways and set 
  157. some strange settings, so be patient.
  158.  
  159. Copy the file Autoexec.TEMPLATE and name the copy Autoexec.net
  160. Replace all occurrences of my_callsign with your actual  in lower 
  161. case.
  162. Replace the one occurrence of IPADDRESS with your actual ip 
  163. address.  Afterwards that line should look like:ip addr [44.112.0.200]
  164. Search for the string QST-0 (that is a zero at the end).  On this line it 
  165. kind of looks like a call sign but the last two bytes are zero.  So you 
  166. need to change the second number which is 112 where I live to be 
  167. the second number from your ip address.
  168. Search for the line hostfile "boot:macnet:Hosts.net", this needs to 
  169. name Hosts.net file.  I don't think it likes spaces much so you may 
  170. need to rename a directory if it has them.
  171. Search for "attach asy 1 a" if you are using the modem  port you are 
  172. all set.  If you are using the printer port change the a to be yielding: 
  173. attach asy 1 b
  174. Now, finally run the net program, leaving Softkiss running.
  175. If net hangs at startup it is usually because the port (modem or 
  176. printer) is not running Softkiss and doesn't have anything attached 
  177. to it, check your configuration
  178. If net give some error messages at startup check your autoexec.net
  179. To monitor packets and see if everything is setup ok. Give net the 
  180. command "trace ax0 111" this opens a window and shows all the 
  181. packets going by.  When you are done quit net and restart it as it 
  182. seems to drop connections when the trace window is open.
  183. To connect to my favorite bbs (w2xo) I use:
  184. c ax0 w2xo
  185.  
  186. There is built in help in net and a sub directory with more 
  187. documentation.
  188. Overall the system needs work and is under construction.
  189. When it doesn't transmit
  190. To make adjustments to Softkiss you need to do:
  191. Run any terminal emulator program such as Red Ryder, White 
  192. Knight, Mac Terminal, Kermit and select the same port you picked in 
  193. the control panel.
  194. You will get the modem> prompt or printer> prompt depending on 
  195. which port you are using.  The help command will give a list of 
  196. commands and their usage.   Typical command sequence
  197. online false
  198. -- make changes
  199. online true
  200. Changes are not saved yet (sorry)
  201. Times are in microseconds
  202. To have finer control for high speed radios Softkiss thinks of time in 
  203. microseconds.  Most TNCs measure time in milliseconds but express it 
  204. in milliseconds/10.  You thought you would never need to use that 
  205. stuff from the exams on micro->milli right?
  206.  
  207. An example, my kam [Kantronics All Mode, a common TNC] manual 
  208. says the default time for txdelay is "30".  But it internally multiples 
  209. by 10, it has a default txdelay of 300 milliseconds.  To convert to 
  210. microseconds for Softkiss add three zeros to yield 300000
  211. tx_delay
  212. This is the delay for your transmitter to key up, squelch to break on 
  213. the receiver and the receiving end to synchronize.  The default is 
  214. 300000 microseconds (which is 3 tenths of a second).  If it is too 
  215. short it won't work.  If it too long it wastes air time.
  216. Once you have things working you can make this number smaller till 
  217. it breaks and back off a little.
  218. If you are using a tx_delay as small as possible, then it makes a 
  219. difference how the other end is set up.  If they using a "DCD detector" 
  220. to run open squelch then when you switch to talk to someone else 
  221. you would need to up the time. 
  222. Ask around to see what folks in your area are using for your kind of 
  223. radio.
  224. tail_delay
  225. After Softkiss transmits all of your data to the serial chip it waits 
  226. while the SCC hardware transmits the final data byte to the radio 
  227. then the checksum and a closing flag.  This time is how long it waits.  
  228. This time does not vary according to your radio, or the radio at the 
  229. other end.
  230. Softkiss should figure it out itself but it doesn't yet.
  231. tail_delay defaults to 50000 microseconds.
  232. If it is too small the receiving end won't understand your packet.
  233. It it is too big you waste air time.
  234. If you are using 300 baud on HF 50000 wont be enough, it needs to 
  235. be large enough for about 4 characters.  I haven't tried it but 150000 
  236. should be enough for 300 baud.
  237. Fairness, xmit_dwait, xmit_slottime, xmit_persist
  238. Softkiss tries to transmit when nobody else is transmitting so that it 
  239. doesn't interfere.  So does everyone else.  These parameters 
  240. (xmit_dwait xmit_slottime, xmit_persist) teach Softkiss the rules that 
  241. the hams in your area use to play fair in transmitting.
  242. If Softkiss is too wimpy it will not transmit because it is being to 
  243. deferential and everyone else will go.
  244. If Softkiss is too aggressive it will transmit on top of other people 
  245. and not give them a chance.
  246. Ask around your area to find what hams are using for dwait, slottime 
  247. and persist.
  248. dwait
  249. This is how long to wait to give digipeaters a chance to go first.  It 
  250. not used in my area anymore since slottime and persist where 
  251. invented so I set it to zero.  Again, remember times are in 
  252. microseconds (see time section above)
  253. xmit_persist
  254. When Softkiss wants to transmit it plays dice.  It takes out it's 1000 
  255. sided die and rolls it.  If the number it rolls is bigger than what you 
  256. picked for xmit_persist it goes to sleep for xmit_slottime then tries 
  257. again.  Being a computer it's die is labeled from 0 to 999.
  258. My kam defaults to 63 for persist but it is 63 on a 256 sided die 
  259. which gives it about a 25% chance of transmitting when it wants to.  
  260. The same chance would be 'xmit_persist 250' to SoftKiss.
  261. If it xmit_persist number is too small everyone else will go and you 
  262. wont take a shot at it.
  263. If it is too small you will jump in and not give everyone else a 
  264. chance.
  265. xmit_slottime
  266. If die roll above for xmit_persist says to take a nap this is how long 
  267. to sleep for.  It defaults to 90000 microseconds which is 90 
  268. milliseconds.  Ask around what folks in your area are using.  Again, 
  269. see the section on time above a kam setting of 90 is 90000 to 
  270. Softkiss.
  271. Future Softkiss Wish List
  272.  
  273. Ñ Interface to Virtuoso to have a better user interface than macnet
  274. Ñ AppleTalk (printing, AppleShare) over radio
  275. Ñ MacTCP (apple's TCP system)
  276. Ñ AfterDark packet monitoring module
  277. Ñ A built in connect command in SoftKiss
  278. Appendix 1
  279.  
  280.     AMPRNet IP address coordinators as of 15 January 1992
  281.  
  282. 44.002    Bob Meyer        K6RTV    Calif: Sacramento
  283. 44.004    Douglas Thom        N6OYU    Calif: Silicon Valley - 
  284. San Francisco
  285. 44.006    Don Jacob        WB5EKU    Calif: Santa Barbara/Ventura
  286. 44.008    Brian Kantor        WB6CYT    Calif: San Diego
  287. 44.010    Terry Neal        AA6TN    Calif: Orange County
  288. 44.012    Steven King        KD7RO    Eastern 
  289. Washington,Idaho
  290. 44.014    John Shalamskas        KJ9U    Hawaii & Pacific 
  291. Islands
  292. 44.016    Jeff Angus        WA6FWI    Calif: Los Angeles - S F 
  293. Valley
  294. 44.017    Dana Myers        KK6JQ    Calif: Antelope 
  295. Valley/Kern County
  296. 44.018    Geoffrey Joy        KE6QH    Calif: San Bernardino & 
  297. Riverside
  298. 44.020    Fred Schneider        K0YUM    Colorado: Northeast
  299. 44.022    John Stannard        KL7JL    Alaska
  300. 44.024    Dennis Goodwin        KB7DZ    Washington state: 
  301. Western (Puget Sound)
  302. 44.026    Ron Henderson        WA7TAS    Oregon
  303. 44.028    Don Adkins        KD5QN    Texas: Dallas
  304. 44.030    J Gary Bender        WS5N    New Mexico
  305. 44.032    Bdale Garbee        N3EUA    Colorado: Southeast
  306. 44.034    Jeff Pierce        WD4NMQ    Tennesee
  307. 44.036    Doug Drye        KD4NC    Georgia
  308. 44.038    Mike Abbott        N4QXV    South Carolina
  309. 44.040    Jeff Jacobsen        WA7MBL    Utah
  310. 44.042    Phil Akers        WA4DDE    Mississippi
  311. 44.044    Ed Thorne        WB1FEM    Massachusetts: western
  312. 44.046    William Simmons        WB0ROT    Missouri
  313. 44.048    Jacques Kubley        KA9FJS    Indiana
  314. 44.050    Ron Breitwisch        KC0OX    Iowa
  315. 44.052    Gary Grebus        K8LT    New Hampshire
  316. 44.054    Ralph Stetson        KD1R    Vermont
  317. 44.056    Don Hughes        KA1MF    Eastern Mass
  318. 44.058    Rich Clemens        KB8AOB    West Virginia
  319. 44.060    Howard Leadmon        WB3FFV    Maryland
  320. 44.062    Jim Dearras        WA4ONG    Virginia (not DC)
  321. 44.064    Dave Trulli        NN2Z    New Jersey: northern 
  322. 44.065    Bob Applegate        WA2ZZX    New Jersey: southern
  323. 44.066    John DeGood        NU3E    Delaware
  324. 44.068    Bob Foxworth        K2EUH    New York: Long Island
  325. 44.069    Paul Gerwitz        WA2WPI    New York: upstate
  326. 44.070    Gary Sanders        N8EMR    Ohio
  327. 44.072    Ken Stritzel        WA9AEK    Chicago - North Ill.
  328. 44.074    James Curran        KA4OJN    North Carolina (east)
  329. 44.075    Charles Layno        WB4WOR    North Carolina (west)
  330. 44.076    Kurt Freiberger        WB5BBW    Texas: south
  331. 44.077    Rod Huckabay        KA5EJX    Texas: west
  332. 44.078    Joe Buswell        K5JB    Oklahoma
  333. 44.080    John Gayman        WA3WBU    Pennsylvania: eastern
  334. 44.082    Steven Elwood        N7GXP    Montana
  335. 44.084    Bob Ludtke        K9MWM    Colorado: Western
  336. 44.086    Reid Fletcher        WB7CJO    Wyoming
  337. 44.088    Jon Bloom        KE3Z    Connecticut
  338. 44.090    Mike Nickolaus        NF0N    Nebraska
  339. 44.092    Pat Davis        KD9UU    Wisconsin, upper peninsula 
  340. Michigan
  341. 44.094    Gary Sharp        WD0HEB    Minnesota
  342. 44.096    Don Bennett        K4NGC    District of Columbia
  343. 44.098    Garry Paxinos        (waiting)    Florida
  344. 44.100    Ken Adkisson        WB4FAY    Alabama
  345. 44.102    Jeff King        WB8WKA    Michigan (lower peninsula)
  346. 44.104    Charles Greene        W1CG    Rhode Island
  347. 44.106    Tyler Barnett        N4TY    Kentucky
  348. 44.108    James Dugal        N5KNX    Louisiana
  349. 44.110    Richard Duncan        WD5B    Arkansas
  350. 44.112    Bob Hoffman        N3CVL    Pennsylvania: western
  351. 44.114    Steven Elwood        N7GXP    N&S Dakota
  352. 44.116    Tom Kloos        WS7S    Oregon: 
  353. NW&Portland,Vancouver WA
  354. 44.118    Jon Andrews        WA2YVL    Maine
  355. 44.120    unassigned
  356. 44.122    Dale Puckett        K0HYD    Kansas
  357. 44.124    David Dodell        WB7TPY    Arizona
  358. 44.125    Earl Petersen        KF7TI    Nevada
  359. 44.126    Karl Wagner        KP4QG    Puerto Rico
  360. #
  361. # 44.128 is reserved for testing.  Do not use for operational networks.
  362. # You may safely assume that any packets with 44.128 addresses are 
  363. bogons
  364. # unless you are using them for some sort of testing
  365. #
  366. 44.128    TEST
  367. #
  368. # International subnet coordinators by country
  369. #
  370. 44.129    Japan        JG1SLY    Tak Kushida, JH3XCU Joly 
  371. Kanbayashi
  372. 44.130    Germany        DL4TA    Ralf D Kloth
  373. 44.131    United Kingdom    G6PWY    Chris ?
  374. 44.132    Indonesia    YB1BG    Robby Soebiakto
  375. 44.133    Spain        EA4DQX    Jose Antonio Garcia.  Madrid. 
  376. (EA4DQX @ EA4DQX)
  377. 44.134    Italy        I2KFX
  378. 44.135    Canada        VE3GYQ    David Toth
  379. 44.136    Australia    VK2ZXQ    John Tanner
  380. 44.137    Holland        PA0GRI    Gerard Van Der Grinten
  381. 44.138    Israel        4X6OJ    Ofer Lapid
  382. 44.139    Finland        OH1MQK    Matti Aarnio
  383. 44.140    Sweden        SM0RGV    Anders Klemets
  384. 44.141    Norway        LA4JL    Per Eotang
  385. 44.142    Switzerland    HB9CAT    Marco Zollinger
  386. 44.143    Austria        OE1KDA    Krzysztof Dabrowski
  387. 44.144    Belgium        ON7LE
  388. 44.145    Denmark        OZ1EUI
  389. 44.146    Phillipines    DU1UJ    Eddie Manolo
  390. 44.147    New Zealand
  391. 44.148    Ecuador        HC5K    Ted
  392. 44.149    Hong Kong    VS6EL
  393. 44.150    Yugoslavia    YU3FK    Iztok Saje
  394. 44.151    France        FC1BQP    Pierre-Francois Monet
  395. 44.152    Venezuela    OA4KO/YV5    Luis Suarez
  396. 44.153    Argentina    LU7ABF    Pedro Converso
  397. 44.154    Greece        SV1IW    Manos
  398. 44.155    Ireland        EI9GL    Paul Healy
  399. 44.156    Hungary        HA5DI    Markus Bela
  400. 44.157    Chile        CE6EZB    Raul Burgos
  401. 44.158    Portugal    CT1DIA    Artur Gomes
  402. 44.159    Thailand    HS1JC    Kunchit Charmaraman
  403. 44.160    South Africa    ZS6BHD    John
  404. 44.161    Luxembourg    LX1YZ    Erny Tontlinger
  405. 44.162    Cyprus        5B4TX    C. Costis
  406. 44.163    Central America    TI3DJT    Chuck Hast
  407. 44.164    Surinam        PZ2AC    Otto Morroy
  408. 44.165    Poland        SP5WCA    Andrzej K. Brandt
  409. 44.166    Korea        HL9TG    Gary ?
  410.  
  411. 44.193    Outer Space-AMSAT    W3IWI        Tom Clark
  412.  
  413.